home *** CD-ROM | disk | FTP | other *** search
/ Euroscene 2 / Euroscene 2.iso / USEFUL / libs / Workbench / xDrop.dok < prev    next >
Encoding:
Text File  |  1995-11-01  |  16.3 KB  |  435 lines
  1. xDrop 2.21
  2. ==========
  3.  
  4. Ein auf XPK basierender Packer/Unpacker
  5. Deutsches Handbuch von Frank Neumann
  6.  
  7.  
  8. ------------------------------------------------------------------------
  9. Versionen:
  10.  
  11. 2.0  - Erste Version, wurde zusammen mit xpk 1.0 veröffentlicht
  12. 2.01 - Kleiner Fehler entfernt (Fenster-Position war falsch)
  13. 2.02 - Fehler durch nicht freigegebenen Speicher entfernt
  14. 2.1  - Aussehen etwas verändert, größeres Listview-Fenster, Modus-Anzeige
  15. 2.11 - Fehler, der einen Enforcer Hit im Panel-Deaktivierungs-Code erzeugte,
  16.        rausgeschmissen (Ch. Schneider)
  17. 2.12 - Fehler bei langen Filenamen entfernt
  18. 2.20 - Neue Option 'Keep file dates'
  19. 2.21 - Erhält jetzt auch Status der Schutzbits und Dateikommentare, zeigt
  20.        den Namen des ausgewählten Packers an, wenn kein Icon-Name in den
  21.        Tooltypes angegeben wurde
  22.  
  23. ------------------------------------------------------------------------
  24. Rechtliches
  25. -----------
  26.  
  27. xDrop ist Copyright © 1992 by Martin A. Blatter. Alle Rechte vorbehalten.
  28.  
  29. xDrop darf zu nichtkommerziellen Zwecken weitergegeben werden.
  30.  
  31. Das Risiko, das durch die Benutzung dieses Programms entsteht, ist das
  32. Problem des Benutzers. Der Autor übernimmt keinerlei Verantwortung
  33. für den Gebrauch/Mißbrauch dieses Programms.
  34.  
  35.  
  36. ------------------------------------------------------------------------
  37. Aufgabe von xDrop
  38. -----------------
  39.  
  40. xDrop ist eine leicht zu bedienende visuelle Benutzer-Schnittstelle zum
  41. XPK Library-System. Es erlaubt Ihnen, durch Bedienung mit der Maus aus
  42. einer Reihe von verschiedenen Packern und Betriebsmodi auszuwählen.
  43.  
  44. xDrop bietet eine Benutzer-Oberfläche, die nach den Regeln des
  45. 'Interface Style Guide' geschrieben ist, und benutzt die Möglichkeiten
  46. von 'AppIcons' und 'AppWindows' von AmigaOS 2.0, um die Arbeit mit ihm
  47. so einfach und angenehm wie möglich zu machen. Durch Verwendung der
  48. von Commodore-Amiga entwickelten 'commodities.library' kann xDrop auf
  49. einen beliebigen 'HotKey' gelegt und vollständig mit Hilfe des
  50. Commodities-Programms 'Exchange' kontrolliert werden.
  51.  
  52.  
  53. ------------------------------------------------------------------------
  54. Voraussetzungen
  55. ---------------
  56.  
  57. - Ein beliebiger Amiga
  58. - Kickstart 2.0 oder höher
  59. - Das xpk-Paket (die xpkmaster.library und mindestens eine
  60.   Kompressions-Library müssen installiert sein)
  61.  
  62.  
  63. ------------------------------------------------------------------------
  64. Starten von xDrop
  65. -----------------
  66.  
  67. xDrop kann entweder von der Workbench oder aus dem CLI heraus
  68. aufgerufen werden.
  69.  
  70. * Benutzung von der Workbench aus
  71.  
  72.   Doppelklicken Sie das xDrop-Icon. Ein sog. 'AppIcon' wird auf dem
  73.   Workbench-Bildschirm erscheinen. Wenn dieses AppIcon nicht erscheint,
  74.   könnten verschiedene Dinge schiefgegangen sein:
  75.  
  76.   - Haben Sie Kickstart 2.0 (oder höher) ?
  77.   - Haben Sie noch genügend freien Speicher ?
  78.   - Haben Sie die 'commodities.library' (liegt der Workbench 2.04 bei)
  79.     im libs:-Verzeichnis ?
  80.   - Ist das xpk-Paket korrekt installiert ?
  81.  
  82.   Wenn etwas schiefgeht, versucht xDrop Ihnen das über System-Fenster
  83.   mitzuteilen.
  84.  
  85.   Wenn das ToolType 'CX_POPUP' (siehe weiter unten für eine Erklärung
  86.   der ToolTypes) auf 'yes' gesetzt ist, wird ein Konfigurations-Fenster
  87.   erscheinen. Siehe dazu das Kapitel 'Konfigurationsfenster' für
  88.   weitere Informationen über dieses Fenster.
  89.  
  90. * Benutzung vom CLI aus
  91.  
  92.   Geben Sie 'xDrop' in einem Shell-Fenster ein. Ein AppIcon wird auf
  93.   dem Workench-Bildschirm erscheinen.
  94.  
  95.   Um xDrop aus dem Speicher zu entfernen, drücken Sie in der Shell,
  96.   in der Sie xDrop gestartet haben, die Tasten CONTROL-C.
  97.  
  98.   Beachten Sie bitte:
  99.  
  100.   Wenn Sie xDrop von der Shell aus starten, werden die im Programm vor-
  101.   gegebenen Grundeinstellungen benutzt. Es ist deshalb von Vorteil,
  102.   xDrop von der Workbench oder von der WBStartup-Schublade aus zu
  103.   starten.
  104.  
  105.  
  106. ------------------------------------------------------------------------
  107. Bedienung
  108. ---------
  109.  
  110. Die Bedienung von xDrop ist sehr einfach:
  111.  
  112. Um Dateien zu packen:
  113.  
  114.    Wählen Sie dazu einfach ein oder mehrere Icons (keine Schubladen)
  115.    auf der Workbench aus, ziehen Sie es/sie über das xDrop-Icon oder
  116.    das xDrop-Konfigurationsfenster (wenn es offen ist), und legen Sie
  117.    die Icons ab (Maustaste loslassen).
  118.  
  119.    Das dann erscheinende Fenster (siehe unten) zeigt Ihnen das
  120.    Fortschreiten des Packvorgangs an, und die Datei wird gepackt;
  121.    dies geschieht entweder über den im Konfigurationsfenster gewählten
  122.    Packer oder über das voreingestellte Tooltype XPK_METHOD (siehe
  123.    unten für eine Erklärung der ToolTypes).
  124.  
  125. Um Dateien zu entpacken:
  126.  
  127.    Um eine gepackte Datei wieder zu entpacken, ziehen Sie sein Icon
  128.    über das xDrop-AppIcon oder das xDrop-Konfigurationsfenster (wenn
  129.    es denn offen ist).
  130.  
  131.    Sie können eine beliebige Anzahl von Icons über xDrop ablegen, egal,
  132.    ob die Dateien gepackt oder ungepackt sind. Beachten Sie bitte, daß
  133.    xDrop zur Zeit nur einzelne Dateien behandeln kann (keine Schubladen).
  134.    Es ist nicht möglich, mehrere Dateien zu einem Archiv zu verknüpfen,
  135.    wie etwa bei zoo oder lharc.
  136.  
  137.  
  138. Um xDrop aus dem Speicher zu entfernen:
  139.  
  140.    xDrop kann jederzeit aus dem Speicher entfernt werden.
  141.  
  142.    - Beenden Sie xDrop über die Funktion 'kill' des Commodities-
  143.      Programms 'exchange'
  144.    - Senden Sie xDrop ein CTRL-C-Signal mit dem 'break'-Befehl. xDrop
  145.      wird sich sauber aus dem Speicher entfernen.
  146.    - Starten Sie xDrop ein zweites Mal. Beide xDrop-Prozesse werden
  147.      sich sofort beenden.
  148.  
  149.  
  150. ------------------------------------------------------------------------
  151. Das Konfigurations-Fenster
  152. --------------------------
  153.  
  154. Das Konfigurations-Fenster ist in drei sichtbar voneinander getrennte
  155. Bereiche unterteilt, die die Namen 'Packer', 'Einstellungen' und 
  156. 'Beschreibung' tragen:
  157.  
  158.  
  159. ________________________________________________________________
  160. |                                                              |
  161. |    Packer                        Beschreibung                |
  162. | ____________     ___________________________________________ |
  163. | |          |     |                                         | |
  164. | |          |     |                                         | |
  165. | |          |     |                                         | |
  166. | |          |     |                                         | |
  167. | |          |     |                                         | |
  168. | |          |     ------------------------------------------| |
  169. | |          |                                                 |
  170. | |          |                      Einstellungen              |
  171. | |          |                                                 |
  172. | |          |                        ________________________ |
  173. | ------------                        |                      | |
  174. | |          |                        |----------------------| |
  175. | ------------                        |______________________| |
  176. |                                                              |
  177. | ____________                                    ____________ |
  178. | | Sichern  |                                    |Verbergen | |
  179. | ------------                                    ------------ |
  180. ----------------------------------------------------------------
  181.  
  182.  
  183. 1. Packer
  184.  
  185. Das 'Packer'-ListView-Fenster erlaubt Ihnen, aus einer Liste von
  186. vorhandenen XPK-Packern und Verschlüsselungs-Programmen auszuwählen,
  187. indem Sie den entsprechenden Namen im Fenster mit der Maus anwählen
  188. (die Packer-Libraries sind für gewöhnlich in der Schublade
  189. 'libs:compressors' untergebracht). Der vertiefte Kasten darunter
  190. zeigt den ausgewählten Packer an.
  191.  
  192.  
  193. 2. Beschreibung
  194.  
  195. Dieses Nur-Lese-Fenster zeigt Informationen über den zur Zeit
  196. ausgewählten Packer/Verschlüsseler an. Sie bestehen aus dem vollen
  197. Namen des Packers und zwei weiteren Zeilen mit Informationen.
  198.  
  199.  
  200. 3. Einstellungen
  201.  
  202. Der Einstellungen-Teil des Konfigurations-Fensters besteht aus zwei
  203. Gadgets, die in Geisterschrift erscheinen können, abhängig von den
  204. Fähigkeiten des zur Zeit ausgewählten Packers:
  205.  
  206.    A. Effizienz
  207.  
  208.       Dieses Proportional-Gadget erlaubt Ihnen, die Effizienz des
  209.       Packvorgangs zu beeinflussen. Der Wert für die Effizienz kann
  210.       im Bereich von 0 bis 100 Prozent liegen. Allerdings muß nicht
  211.       jeder Packer 100 einstellbare Packstufen anbieten, und genauso
  212.       wenig muß ein Packer überhaupt mehrere einstellbare Stufen
  213.       haben.
  214.  
  215.       Eine textuelle Beschreibung des zur Zeit engestellten Effizienz-
  216.       Wertes erhalten Sie, wenn Sie den Menüpunkt 'Informationen' aus dem
  217.       Projekt-Menü des xDrop-Fensters auswählen.
  218.  
  219.       Ab Version 2.1 wird diese Beschreibung auch links neben dem
  220.       Proportional-Gadget ausgegeben.
  221.  
  222.  
  223.    B. Passwort
  224.  
  225.       Dieses Text-Gadget ermöglicht Ihnen, bei Packern, die eine
  226.       Verschlüsselung erlauben, ein Passwort anzugeben.
  227.  
  228.       Das Passwort darf nicht länger als 15 Zeichen sein.
  229.  
  230. 4. Weitere Gadgets:
  231.  
  232.    A. Sichern
  233.  
  234.       Speichert die aktuellen Einstellungen im xDrop-Icon ab. Diese
  235.       Funktion kann auch mit der Tastatur-Abkürzung 'S' ausgelöst
  236.       werden.
  237.  
  238.    B. Verbergen
  239.  
  240.       Versteckt das Konfigurations-Fenster, ohne xDrop zu beenden.
  241.       Damit werden die aktuellen Voreinstellungen benutzt, ohne
  242.       abgespeichert zu werden.
  243.       Tastatur-Abkürzung: H
  244.  
  245.  
  246. 5. Das Schließ-Gadget
  247.  
  248. Das Schließ-Gadget des Fensters tut dasselbe wie der 'Verbergen'-Knopf.
  249.  
  250.  
  251. 6. Menüs.
  252.  
  253.    A. Projekt
  254.  
  255.       Über xDrop - Zeigt Informationen über das Programm und seinen
  256.                    Autor an.
  257.                    Abkürzung: Rechte Amiga-Taste und A
  258.  
  259.       Informationen - Zeigt die Einstellungen und weitere Informationen
  260.                       über den augenblicklich ausgewählten Packer an.
  261.                       Abkürzung: Rechte Amiga-Taste und I
  262.  
  263.       Verbergen - Versteckt das Konfigurations-Fenster, ohne xDrop zu
  264.                   beenden. Es werden die aktuellen Einstellungen benutzt,
  265.                   aber nicht abgespeichert.
  266.                   Abkürzung: Rechte Amiga-Taste und H
  267.  
  268.       Beenden - xDrop vollständig aus dem Speicher entfernen
  269.  
  270.    B. Optionen
  271.  
  272.       Original behalten - Wenn dieser Menüpunkt aktiviert ist (durch das
  273.                           kleine Häkchen links neben dem Menütext), wird
  274.                           xDrop die Original-Datei behalten und der
  275.                           gepackten Version der Datei die Endung '.xpk'
  276.                           anhängen. Icons werden übernommen. Die '.xpk'-
  277.                           Endung wird gelöscht, wenn die Datei wieder
  278.                           ausgepackt wird.
  279.  
  280.                           Wenn der Menüpunkt nicht aktiviert ist, wird
  281.                           xDrop die Originaldatei beim Packen mit der
  282.                           gepackten Datei überschreiben.
  283.  
  284.       Dateiinformationen behalten 
  285.                      - Wenn diese Option aktiviert ist, wird die
  286.                        gepackte Datei dieselbe Datumsmarkierung,
  287.                        Dateikommentar und Schutzbits wie die Original-
  288.                        Datei erhalten. Diese Option ist sehr nützlich,
  289.                        wenn Sie Dateien (z. B. verschiedene Teile eines
  290.                        Quellcodes) bearbeiten und es erforderlich wird,
  291.                        anhand der Datumsmarkierung festzustellen,
  292.                        welche Version einer Datei die neuere ist.
  293.  
  294.  
  295. ------------------------------------------------------------------------
  296. Das Zeitablaufs-Fenster (meine Güte, hat mal jemand ein gutes deutsches
  297. Wort für 'progress indicator' ? :-} )
  298. -----------------------
  299.  
  300. Während es Dateien packt/entpackt, zeigt xDrop in einem speziellen
  301. Fenster, das in der oberen linken Ecke der Workbench erscheint, den
  302. Fortgang seiner Arbeit an. Eine Leiste, die von links nach rechts
  303. aufgefüllt wird, zeigt an, zu wieviel Prozent die Arbeit bereits getan
  304. ist. Dies wird nicht mit allen Packern zusammenlaufen, einige werden
  305. nur eine Änderung in diesem Fenster anzeigen, wenn der Pack/Entpack-
  306. Vorgang abgeschlossen ist. Dieses Fenster zeigt außerdem noch die
  307. Anzahl an bereits bearbeiteten Bytes, die insgesamt zu bearbeitende
  308. Zahl Bytes und die (De-)Kompressionsgeschwindigkeit an.
  309.  
  310. (De-)Kompression kann jederzeit durch Betätigen des Schließ-Gadgets
  311. abgebrochen werden; Sie werden dadurch keine Daten verlieren. xDrop
  312. überschreibt niemals die Original-Datei, bevor es nicht mit der (De-)
  313. Komprimierung vollständig fertig ist.
  314.  
  315.  
  316. ------------------------------------------------------------------------
  317. Tool Types
  318. ----------
  319.  
  320. Die folgenden ToolTypes werden unterstützt:
  321.  
  322.  
  323. CX_POPUP  - Wenn Sie möchten, daß xDrop sein Konfigurations-Fenster
  324.             beim ersten Start sofort öffnet, setzen Sie diese Option
  325.             auf 'yes':
  326.  
  327.                         CX_POPUP=yes
  328.  
  329.             Wenn Sie hingegen möchten, daß xDrop beim ersten Start
  330.             im Hintergrund läuft, z.B. wenn Sie es aus der WBStartup-
  331.             Schublade heraus starten, setzen Sie dies auf 'no':
  332.  
  333.                         CX_POPUP=no
  334.  
  335. CX_POPKEY - Tastenkombination, mit der sich das Konfigurations-Fenster
  336.             öffnen läßt. Voreinstellung:
  337.                         CX_POPKEY=alt shift f9
  338.  
  339. CX_PRIORITY - Priorität des xDrop-Commodities. Voreinstellung:
  340.                         CX_PRIORITY=0
  341.  
  342. XPK_METHOD - Stellt den zu verwendenden Packer ein. Dieses Tooltype
  343.              wird durch das Konfigurations-Fenster verwaltet, und
  344.              sollte nicht vom Benutzer verändert werden.
  345.                         XPK_METHOD=NUKE
  346.  
  347. XPK_PRIORITY - Setzt die Priorität des Pack/Entpack-Tasks.
  348.                Sie sollten diesen Wert nur ändern, wenn Sie wirklich
  349.                wissen, was Sie tun. Voreinstellung:
  350.                         XPK_PRIORITY=0
  351.  
  352. LANGUAGE - Bestimmt die Sprache, in der das Programm mit Ihnen
  353.            kommuniziert. Mögliche Werte:
  354.                         LANGUAGE=German     (Deutsch)
  355.                         LANGUAGE=English    (Englisch)
  356.  
  357.            Dieses ToolType überschreibt globale Sprachen-
  358.            Einstellungen. Wenn Sie die System-Voreinstellungen
  359.            für die Sprache benutzen wollen, entfernen Sie dieses
  360.            ToolType.
  361.  
  362. ICONNAME  - Erlaubt Ihnen, mit einem String den Namen des AppIcons
  363.             zu setzen.
  364.             Beispiel:
  365.                         ICONNAME=Schlürf
  366.  
  367.             Wenn dieses ToolType nicht gesetzt wird, erhält das
  368.             AppIcon als Namen den Namen des zur Zeit eingestellten
  369.             Packers.
  370.  
  371. ICONXPOS  - Setzt die gewünschte X-Koordinate des AppIcons. Beachten
  372.             Sie bitte, daß ab Kickstart-Version 2.0 die Workbench das
  373.             AppIcon an eine andere Position als von Ihnen gewünscht
  374.             setzen kann.
  375.             Beispiel:
  376.                         ICONXPOS=600
  377.  
  378. ICONYPOS  - Setzt die Y-Koordinate der Position, an der das AppIcon
  379.             erscheinen soll. Beachten Sie bitte auch hier, daß ab
  380.             Kickstart 2.0 die Workbench das AppIcon an eine andere
  381.             Position als hier eingestellt bewegen kann.
  382.  
  383. KEEPORIGINAL - Wenn dieses ToolType auf 'yes' gesetzt ist, wird xDrop
  384.                die Original-Datei behalten und eine Endung '.xpk' an
  385.                den Dateinamen der gepackten Datei anhängen. Icons
  386.                werden übernommen. Wenn die Datei wieder ausgepackt
  387.                wird, wird die Endung '.xpk' entfernt.
  388.  
  389.                Wenn das ToolType auf 'no' (Voreinstellung) gesetzt ist,
  390.                wird xDrop die Original-Datei mit der gepackten Version
  391.                der Datei überschreiben.
  392.  
  393.                Beispiel:
  394.                         KEEPORIGINAL=no
  395.  
  396.                Wenn dieses ToolType nicht gesetzt ist, wird es mit 'no'
  397.                voreingestellt.
  398.  
  399. KEEPFILEINFO - Wenn dieses ToolType auf 'yes' gesetzt ist, wird die
  400.                neue Datei dieselbe Datumsmarke, Dateikommentar und
  401.                Schutzbits wie die Original-Datei erhalten. Andernfalls
  402.                erhält die neue Datei das aktuelle Datum, die aktuelle
  403.                Zeit und voreingestellte Schutzbits.
  404.  
  405.                Beispiel:
  406.                         KEEPFILEINFO=yes
  407.  
  408.                Voreingestellt ist 'no'.
  409.  
  410.  
  411. ------------------------------------------------------------------------
  412. Sonstiges
  413. ---------
  414.  
  415. Autor:  Martin A. Blatter
  416.         Pfaffächerstr. 59
  417.         CH-8913 Ottenbach
  418.         Schweiz
  419.  
  420. E-Mail: blatter@amiga.physik.unizh.ch
  421.         cbmvax!cbmehq!cbmswi!zethos!blatter
  422.  
  423. Fehlerreporte oder Vorschläge werden gerne angenommen, aber *bitte*
  424. benutzen Sie entweder E-Mail oder normale Post (keine Telefonanrufe!).
  425. Danke.
  426.  
  427. Dieses Programm benutzt Relog AG's ITools (tm), das objekt-orientierte
  428. Benutzerschnittstellen-System von Christian A. Weber.
  429.  
  430. Besonderen Dank an:
  431.  
  432. - U. Dominik Mueller für Teile des Handbuchs.
  433. - Frank Neumann für das deutsche Handbuch.
  434.  
  435.